Book Contents

Connections for the EmailSender ActiveX control

The following table shows the connections to control the operation of the EmailSender ActiveX control at run time.

Connections

Descriptions

Trigger

Required

When the assigned tag transitions from a zero to non-zero value, the control reads the values of the other connections and attempts to send an email.

The connection can be a tag, tag placeholder "{#1}", or expression.

SMTPSrvrAddress

Required

This connection contains the server name (for example, smtp.gmal.com) or IP address of the SMTP Server (for example, 200.71.232.10).

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "smtp.gmail.com").

SMTPPort

Required

This connection contains the TCP/IP port (for example, 25) used to communicate with the SMTP server.

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "25").

SMTPUserID

Optional

This connection contains the user id (for example, myusername) to be used to authenticate with a SMTP server that requires authentication.

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "myusername").

SMTPUserPwd

Optional

This connection contains the password associated with the user ID, contained in SMTPUserId (for example, P@as5word), to be used to authenticate with a SMTP server that requires authentication.

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "P@as5word").

SSLEnable

Optional

When the value is non-zero, the SMTP Email control uses Secure Socket Layer (SSL) protocol to communicate with the SMTP Server.

When the value is zero or blank, the SMTP Email control does not use Secure Socket Layer (SSL) protocol to communicate with the SMTP Server.

The connection data type is String.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "True").

SendAnonymous

Optional

When the value is non-zero, the SMTP Email control does not attempt to authenticate with the SMTP Server before attempting to send an email. When sending an email, anonymously SMTPUserId and SMTPUserPwd should be left blank.

When the value is zero or blank, the SMTP Email control authenticates with the SMTP Server using the credentials contained in SMTPUserId and SMTPUserPwd.

The connection data type is String.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "True").

From_Address

Required

This connection contains the email address of the sender (for example, myEmail@emaildomain.com).

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "myEmail@emaildomain.com").

From_Name

Optional

This connection contains the name of the sender (for example, "Palletizer 22B", "PanelView Plus Alarm", or "Fred")

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "Fred").

TO_Address

Optional

This connection contains the TO recipients of the email (for example, Fred@att.net). Comma separate the individual emails if a list is desired.

At least one email address among the TO_address, CC_address, and BCC_address connections must contain a valid email address or the send operation will fail.

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "Fred@emaildomain.com").

CC_Address

Optional

This connection contains the CC recipients of the email (for example, Fred@att.net). Comma separate the individual emails if a list is desired.

At least one email address among the TO_address, CC_address, and BCC_address connections must contain a valid email address or the send operation will fail.

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "Fred@emaildomain.com").

BCC_Address

Optional

This connection contains the BCC recipients of the email (for example, Fred@att.net). Comma separate the individual emails if a list is desired.

At least one email address among the TO_address, CC_address, and BCC_address connections must contain a valid email address or the send operation will fail.

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "Fred@emaildomain.com").

Subject

Optional

This connection contains the subject (for example, Alarm email) of the email being sent.

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "Alarm Email").

Body

Optional

This connection contains the body (for example, The level of the tank is 100 psi) of the email being sent.

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "The level of the tank is 100 psi.").

BodyFile

Optional

This connection contains the path (for example, C:\SMTP Files\ALARM.TXT) to a text file containing the body of the email. When the email is sent the control reads specified text file and sends that content as the email body. Only simple text (.txt) files are supported.

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "\my documents\alarm.txt").

AttachmentFile

Optional

This connection contains the path (for example, C:\SMTP Files\ALARM.TXT) to a file to be attached to the email. When the email is sent the control reads specified file path and attaches the file to the email.

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "\my documents\readings.csv").

AttachmentFailure

Optional

When this value is non-zero and the file specified in AttachmentFile cannot be attached to the email, this connection causes the email send operation to fail.

The connection data type is String.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "\my documents\readings.csv").

Signature

Optional

This connection contains the signature (for example, Palletizer 22B or Fred Smith) of the email being sent.

The connection data type is String. The maximum length is 82 characters.

The connection can be a tag, tag placeholder "{#1}", expression, or explicit string (for example, "Fred Smith").

Handshake

Optional

When triggered the control writes the status of the email send operation. Non-zero result indicates success. Zero result indicates failure.

The connection data type is Integer.

The connection can be a tag or tag placeholder "{#1}".

FailureCode

Optional

When a send attempt fails the control writes a string message to this connection indicating the cause of the failure.

The connection data type is String.

The connection can be a tag or tag placeholder "{#1}".

See also

EmailSender ActiveX control

FailureCode connection values

If failed in sending an attachment that is smaller than 10 MB